home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / rad204.arc / RADPLUS.DOC < prev    next >
Text File  |  1991-05-11  |  19KB  |  529 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.           :::::::::::::::        :::::::::::::      ::::::::::::::
  24.           ::::::::::::::::      :::::::::::::::     ::::::::::::::::
  25.           :::::       :::::    :::::       :::::    :::::      ::::::
  26.           :::::       :::::    :::::       :::::    :::::       :::::
  27.           ::::::::::::::::     :::::::::::::::::    :::::       :::::
  28.           :::::::::::::::      :::::::::::::::::    :::::       :::::
  29.           :::::    :::::       :::::       :::::    :::::       :::::
  30.           :::::     :::::      :::::       :::::    :::::      ::::::
  31.           :::::      :::::     :::::       :::::    ::::::::::::::::
  32.           :::::       :::::    :::::       :::::    ::::::::::::::   Plus
  33.  
  34.  
  35.                          Remote Access Database v2.00
  36.  
  37.                     (dBASE III & dBASE III Plus Compatible)
  38.  
  39.                          Copyright (C) 1990 Overerx Inc.
  40.                 Box 323 Sta A, Kingston, Ontario, Canada K7M 6R2
  41.                        Harvey Parisien * FidoNet 1:249/114
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. RAD Plus - Remote Access Database
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.                            Background / What is RAD?
  82.  
  83.  
  84.  
  85.          RAD v1.?? has been around for a while now.  It is a simple
  86.          online database system with it's own dedicated file
  87.          structure.  It is simple to operate, and serves a purpose.
  88.          Primarily it is directed towards BBS use.  It is available on
  89.          a shareware basis and distributed via SDS (Software
  90.          Distribution System).
  91.  
  92.          RAD Plus v2.?? is the commercial version which is in dBASE
  93.          III format file structure for optimum flexibility and
  94.          compatibility with current and future environments.  It tends
  95.          to simulate standard dBASE<tm> type commands, which are
  96.          familiar to dBASE users.  It is also offered on a shareware
  97.          basis and distributed via SDS.
  98.  
  99.          This document will deal only with RAD Plus, but will simply
  100.          make reference to the name RAD to save key strokes.
  101.  
  102.          We will refer to the RAD Operator, and the RAD User.  The RAD
  103.          Operator is the System Operator (SysOp) or the System
  104.          Administrator whatever the case may be.  The RAD User is the
  105.          remote caller.
  106.  
  107.          RAD is designed with many considerations to offer maximum
  108.          security to the BBS SysOp, and in non-bbs (less secure)
  109.          environments.  However, the concern for security does not
  110.          make remote maintenance difficult for the RAD Operator.  All
  111.          maintenance can be performed remotely with the correct
  112.          security level.  For non-bbs type setups, you may request
  113.          from the author a Host/Terminal system which will allow
  114.          control of your computer remotely (including file transfers),
  115.          and can be used to answer the phone for RAD, clear passwords,
  116.          and so on (it will create a dorinfo1.def exit file - more on
  117.          that later).  HTERM is a nice terminal for the remote user as
  118.          well, written by the author of RAD.  It is available as
  119.          freeware on most BBS systems, or request HTERM.LZH from the
  120.          FidoNet address stated below.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                      Page 1
  131.  
  132.  
  133.  
  134. RAD Plus - Remote Access Database
  135.  
  136.  
  137.                          Files required to setup RAD...
  138.  
  139. RAD comes in an archived format.  We use LHARC as our standard, but some BBS's
  140. or distribution systems may convert the archive structure.  The archive name is
  141. usually RAD???.LZH where ??? is the version number.  IE:  RAD201.LZH is the
  142. archive for version 2.01.
  143.  
  144. The files in RAD???.LZH are:
  145.  
  146.     DB.EXE       A dBASE III file editor (used for setup).
  147.     DB.DOC       Documentation for above.
  148.   * RADPLUS.EXE  RAD the program.
  149.     RADPLUS.DOC  This document.
  150.   * RADCFG.DBF   RAD's main configuration file.
  151.   * RADDIR.DBF   RAD's file directory/file subject file.
  152.  
  153.                  * = required for RAD to operate.
  154.  
  155.     ARTICLES DBF   Sample database...
  156.     BOOKS    DBF   Sample database...
  157.     PHONEMSG DBF   Sample database...
  158.     SERVICES DBF   Sample database...
  159.     SUPPORT  DBF   Sample database...
  160.     TTD      DBF   Sample database...
  161.  
  162.     FREE.TXT   Some general information text files...
  163.     INFO.TXT   Some general information text files...
  164.     RAD200.SDA Some general information text files...
  165.     HTERM.DOC  The documentation file that comes with hterm for your interest.
  166.  
  167.     REGISTER.TXT   An application for to register RAD.
  168.  
  169.     DORINFO1 DEF   Sample exit file (created by BBS or other answering devices)
  170.  
  171. The only files required to run RAD are the ones marked with a *.  Your security
  172. levels and modem information etc. are contained in RADCFG.DBF and RADDIR.DBF.
  173. Let's look at each file and discuss them in detail.  Use DB.EXE to edit both
  174. RADDIR.DBF and RADCFG.DBF for your initial setup.
  175.  
  176.  
  177.                                    RADCFG.DBF
  178.  
  179. Record:  1  of  1
  180.  
  181. SYSOP_NAME :Harvey Parisien                    :
  182. SYSTEMNAME :The Lighthouse BBS                      :
  183. KEY        :0000000000000000000000000000:
  184. LEVEL1     :    5:
  185. LEVEL2     :   20:
  186. LEVEL3     :   40:
  187. LEVEL4     :  100:
  188. USAGE_LOG  :                                        :
  189. DOOR_INFO  :dorinfo1.def                            :
  190. MIN_TIME   :     5:
  191. MAX_TIME   :   120:
  192. COM_PORT   :COM1:
  193. MAX_BAUD   :2400  :
  194. USE_SCREEN :T:
  195.  
  196.                                      Page 2
  197.  
  198.  
  199.  
  200. RAD Plus - Remote Access Database
  201.  
  202.  
  203.  
  204. SYSOP_NAME is the name of the System Operator (can be a department or company
  205. name also), and SYSTEMNAME is the BBS name (can be just an internal system name
  206. of any sort).  The KEY field must contain the key you receive when you register
  207. RAD Plus.  When you have the key entered, it will not bother reminding you to
  208. register any more.
  209.  
  210. Level1 through to level4 are basically translation tables to translate your
  211. numeric security levels from your BBS, to RAD's 4 basic user levels.  In the
  212. scenario above, in order to have level 3 access, your BBS access level must be
  213. at least 40 or greater.
  214.  
  215. If you would like RAD to keep a usage log for you, enter a complete drive spec
  216. and path for your log file.  The log will record logons, and database changes,
  217. and each applicable record number.  Here's an example...
  218.  
  219. 11/04/90 15:46:32 Logged ON  ******** `JASON MURDUCK'
  220. 11/04/90 15:46:50  File write: SUPPORT.DBF  3
  221. 11/04/90 15:46:54  SysOp chat...
  222. 11/04/90 15:50:30  ...chat over.
  223. 11/04/90 15:50:32 Logged OFF ********
  224.  
  225. DORINFO1.DEF is a standard exit control file produced by QuickBBS and other
  226. popular BBS systems, containing the current users information.  As your BBS
  227. system exits to operate an external program like RAD, it writes this little
  228. file to allow the external program to read it and have the current transfer
  229. information.  Take a look at the file description that follows for the type of
  230. information it contains.  If you describe dorinfo1.def complete with drive spec
  231. and path, it will be used to decide whether the user can support ANSI/Color, how
  232. much time he/she has left online, current access level, etc...
  233.  
  234. If you do not have a parent system that creates DORINFO1.DEF, let us know and
  235. we'll try to accommodate.  Most BBS systems produce exit control files of one
  236. type or another, and there are many little conversion programs available on
  237. BBS's that will convert from one to another.  In that case you would have to run
  238. RADPLUS from a batch file.  For example
  239.  
  240. Sample batch for systems that don't produce dorinfo1.def
  241.  
  242. WINGWANG     ... THE BBS SYSTEM
  243. CONVERT      ... THE CONVERTER (changes wingwang.xit to dorinfo1.def)
  244. RADPLUS      ... RADPLUS
  245.  
  246. Sample dorinfo1.def...
  247.  
  248. The Lighthouse BBS      ;Systems name
  249. HARVEY                  ;SysOps first name
  250. PARISIEN                ;SysOps last name
  251. COM1                    ;Current port
  252. 2400 BAUD,N,8,1         ;Current connection information
  253. 0
  254. JOHN                    ;User's first name
  255. SMITH                   ;User's last name
  256. KINGSTON, ON            ;User's address
  257. 1                       ;ANSI on/off flag
  258. 20                      ;User's SECURITY LEVEL
  259. 59                      ;User's MAX TIME ALLOWED (balance of time from recent
  260.                                                   BBS activities)
  261.  
  262.                                      Page 3
  263.  
  264.  
  265.  
  266. RAD Plus - Remote Access Database
  267.  
  268.  
  269.  
  270. The next fields MIN_TIME and MAX_TIME are online time limits, and are in
  271. minutes.  If you enter information here, it overrides dorinfo1.def (can be used
  272. for systems that don't produce dorinfo1.def to limit access time).  IE, if your
  273. user has 90 minutes left online and your MAX_TIME is set to 10, then he/she will
  274. have 10 minutes in RAD only.  It is recommended that you set MIN_TIME to 0 if it
  275. is your intention to NOT allow further access once a users time has run out.
  276.  
  277. Your COM_PORT must be described as COM1, COM2, COM3, or COM4.
  278.  
  279. Your MAX_BAUD can range from 300 baud to 115200 baud.
  280.  
  281. The USE_SCREEN field is a logical setting of T or F (true or false).  If you set
  282. this to F then the screen will remain BLANK during RAD operations.  This may be
  283. desirable for multitasking situations.  Normally this would be T.  It is
  284. possible for the SysOp while the user is online to turn the screen ON or OFF by
  285. pressing F2 (snoop) on the HOST system.  It is also possible for a user with the
  286. maximum level 4 setting to turn the screen on or off remotely.
  287.  
  288.                                    RADDIR.CFG
  289.  
  290.  
  291. Record:  1  of  8
  292.  
  293. FILE       :RADCFG.DBF  :
  294. SUBJECT    :RAD Main Configuration File             :
  295. DISPLAY_ON :T:
  296. USER_NOTES :SYSOP                                             :
  297. DISPLAY1   :Keep this file marked private                          :
  298. DISPLAY2   :                                                       :
  299. DISPLAY3   :This file contains your setup and default information. :
  300. DISPLAY4   :                                                       :
  301. DISPLAY5   :Use DB3ED (DB.EXE) or RAD to edit this file.           :
  302. DISPLAY6   :                                                       :
  303. DISPLAY7   :NOTE:  Leave the field DOOR_PATH blank if you will be  :
  304. DISPLAY8   :       using RAD offline only!                         :
  305. PASSWORD   :YOURPASSWORD    :
  306. MIN_LEVEL  :4:
  307.  
  308. This database file contains the FILE name and SUBJECT line for each file that is
  309. to be displayed by a DIR command online.  If a *.dbf file exists and is not
  310. recorded in the RADDIR file, it will show up in a DIR, but will have a ? for
  311. subject line and have no password or minimum level access requirement.  The
  312. third field DISPLAY_ON can be set to T or F.  It determines whether the Display1
  313. through to Display8 fields are displayed when the file is accessed with a DIR
  314. command.  Display1 to Display8 are not displayed when the file is accesed using
  315. a USE command.  See the next few screens which simulate the DIR and file
  316. selection screens.  USER_NOTES can be anything you like.  The person who lists
  317. the file usually puts his/her John/Martha Henry here, and grocery list or
  318. whatever else comes to mind.  PASSWORD is your 16 character password required
  319. for this file.  You don't need a password for the MIN_LEVEL system to work.  The
  320. MIN_LEVEL is an absolute minimum access level required to even have the ability
  321. to enter a password.  The TWO levels of security for each database file should
  322. cover most situations.  MAKE SURE YOUR RADCFG.DBF AND RADDIR.DBF FILES ARE BOTH
  323. PASSWORDED AND SET TO 4 AS THE MIN_LEVEL.  If you do not want to allow online
  324. editing of these two files by a remote SysOp, then set the MIN_LEVEL to 5 so it
  325. can't be accessed at all.
  326.  
  327.  
  328.                                      Page 4
  329.  
  330.  
  331.  
  332. RAD Plus - Remote Access Database
  333.  
  334.  
  335. Here is a DIR simulation from the dot prompt...
  336.  
  337. .dir
  338.  
  339.  RAD v2.01 - Remote Access Database - Copyright (C) 1990 Overerx Inc.
  340.  
  341.   # Filename      Records  Updated   Subject
  342.   1 BBSLIST.DBF      1280  11/04/90  A list of BBS's with >= 100megs online
  343.   2 DB.DBF              3  11/04/90  A list of contacts for local services...
  344.   3 IDEAS.DBF           1  11/04/90  Ideas for RAD databases ...
  345.   4 SUPPORT.DBF        68  11/04/90  Computer related product support lines
  346.  
  347.   Enter # _
  348.  
  349. NOTE: RADCFG.DBF and RADDIR.DBF will not be displayed in a Directory.
  350.  
  351. When you enter RAD, you are presented with a pretty nifty title page (free ad
  352. for me), and then displayed your current stats like the following session
  353. simulation.  We enter the HELP command which shows a command summary...
  354.  
  355. 11/05/90  9:48a
  356.  
  357. Registered to.......... The Lighthouse BBS
  358. System Operator........ Harvey Parisien
  359. User................... HARVEY PARISIEN
  360. User level............  4
  361. Balance online time...  19 minutes
  362.  
  363. Hello HARVEY ...
  364.  
  365. (Enter HELP for commands)
  366. .help
  367.  
  368. Command:         Function:                                            Level:
  369. HELP             (or ?) Display this screen  (/=Quick Help Screen)         1
  370. INFO             Display system and user information                       1
  371. CLS              Clears Screen and Resets FIND search to ALL               1
  372. COLOR            Toggles Ansi Color ON/OFF                                 1
  373. DIR              Displays directory of *.DBF files                         1
  374. USE filename.dbf USE or LOAD database (.dbf not required)                  1
  375. LIST STRUCTURE   List the file structure for the current database          1
  376. FIND text        FIND and display record matching text                     1
  377. BROWSE text      FIND and list records (max fields that fit on one line)   1
  378. NEXT             FIND and display NEXT record (or just press ENTER)        1
  379. GOTO n           where n is the record number (also GOTO FIRST or LAST)    1
  380. COUNT            FIND and COUNT occurrences of FIND                        1
  381. SUM fieldnumber  Add contents of a field and display total                 1
  382. ADD              ADD (or append) a new record                              2
  383. EDIT n           n is an optional record number (default = current record) 2
  384. DELETE n         n is an optional record number (default = current record) 2
  385. CREATE           Closes current file, and prompts for creation details     3
  386. PACK             Pack current database (removes deleted files)             3
  387. SORT fieldnumber SORT database on a field (will prompt for fieldnumber)    3
  388. QUIT             Exit program (closes all files)
  389. .
  390.  
  391.  
  392.  
  393.  
  394.                                      Page 5
  395.  
  396.  
  397.  
  398. RAD Plus - Remote Access Database
  399.  
  400.  
  401. You can also ask for a Quick Help Screen which is a brief summary of the above
  402. command list...
  403.  
  404. ./
  405. HELP     ? or /   INFO     CLS      DIR      USE      LIST S   FIND
  406. BROWSE   NEXT     GOTO     COUNT    SUM      ADD      EDIT     DELETE
  407. CREATE   PACK     SORT     SCREEN   QUIT
  408.  
  409. The online commands will be very intuitive to dBASE users and non dBASE users
  410. alike.  The screens and prompts should provide adequate information for the
  411. typical user online.
  412.  
  413.                                  SYSOP FUNCTIONS
  414.  
  415. USER: Joe Blow                PARAM: COM1:2400,N,8,1,RB1024,XON       LEVEL:  3
  416. 1 CHAT |2 SNOOP|3      |4      |5      |6 JUMP |7      |8      |9 LEVEL|10 HANG
  417.  
  418. The last two lines on your HOST screen remain in position at all times.  They
  419. constantly display the Users name, and current communications data.  It shows
  420. the users level which can be toggled with F9.  OK, let's continue from right to
  421. left just to be different.  F10 causes an immediate hang up to which the user is
  422. given no indication or warning as to what happened.  F6 allows the host to jump
  423. to DOS.  F2 allows the HOST to toggle the HOST screen on/off.  F1 allows the
  424. host to enter into CHAT mode, where both host and user can chat to each other
  425. with their keyboards.  By the way, when a users time online gets to be 2 minutes
  426. or less, he/she is given a warning to that effect (even if in chat mode).  They
  427. can always enter INFO to see their current status.
  428.  
  429.  
  430.          Operating RAD Plus from the command line, or a parent program.
  431.  
  432. RADPLUS /Pdrive:fullpath
  433.  
  434. IE: from a DOS prompt...   D:\>c:\dbase\radplus /Pc:\dbase
  435.  
  436. drive:path is where RADPLUS.EXE RADDIR.DBF RADCFG.DIR AND *.DBF files are kept.
  437.  
  438. If no path is given the current directory is assumed.
  439.  
  440. IE: QuickBBS type 7 command line:  c:\rad\radplus.exe /Pc:\rad
  441.  
  442. It is important that if /P is used, that the path is complete with drive spec
  443. as in these examples.
  444.  
  445. If you are operating RAD locally (ie from your BBS in local mode) it will
  446. sense there is no carrier so it requires you to press L to enter locally or
  447. it exits back to the board automatically.  RAD has a built in carrier detect
  448. system.  If carrier is dropped while a user is in RAD (or on their way to rad),
  449. it gracefully exits back to your board and let's your board do it's own thing.
  450.  
  451. Please feel free to contact me in the SHAREWARE echo of FidoNet.  If you are a
  452. registered user (or planning to be if RAD suits your purpose), feel free to
  453. NETMAIL anytime for instant support.
  454.  
  455.                        Harvey Parisien, FidoNet 1:249/114
  456.                 Box 323 Sta A, Kingston, Ontario, Canada K7M 6R2
  457.                                 613-389-3992 BBS
  458.  
  459.  
  460.                                      Page 6
  461.  
  462.  
  463.  
  464. RAD Plus - Remote Access Database
  465.  
  466.  
  467.  
  468. This program is shareware.  It may be used for a 20 day trial period, and then
  469. must be registered.
  470.  
  471.  
  472.  
  473.                                   REGISTRATION
  474.  
  475.  
  476. RADCFG requires a unique KEY to be entered in the key field.  By providing us
  477. with your SYSOP_NAME and SYSTEMNAME field information from RADCFG, we can create
  478. the key.  Once you enter the key, you can't change SYSOP_NAME or SYSTEMNAME
  479. afterwards, or the key will not work.  This is our only protection.  There are
  480. not timers, or other sneaky methods implemented in your program.  RAD is fully
  481. functional.  To register, please fill out the REGISTER.TXT application.  You can
  482. load it into your word processor and edit it, or copy it to your printer and do
  483. it by hand (COPY REGISTER.TXT PRN).  Send it to Overerx Inc.  (address is
  484. contained in register.txt and also above).  (I would prefer that you also
  485. enclose a simple screen dump of your RADCFG file showing me the exact SYSOP_NAME
  486. and SYSTEMNAME entries for key creation)
  487.  
  488. When you receive your REGISTRATION KEY, enter it in the KEY field of RADCFG.
  489. RAD will then be registered and legally yours.  In addition, you will be able to
  490. use future updates of RAD Plus using the same REGISTRATION KEY.  So when you
  491. register once, you never pay again.
  492.  
  493.  
  494.                              Registration is $65.00.
  495.  
  496.           Non Commercial BBS SysOps may register RAD Plus for $ 25.00.
  497.  
  498.  
  499.                         CUSTOM APPLICATIONS AVAILABLE !!!
  500.  
  501.  
  502.  
  503.  
  504.                                    LEGAL STUFF
  505.  
  506. DISCLAIMER - This program is provided as is.  You may use it at your own risk.
  507. There is no warranty of any kind or any form covering this program.  The author
  508. may in no way be held liable for any damage of any form in connection or arising
  509. from the quality and/or use of this program and any associated files included
  510. with it.
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.                  ** YOUR FEEDBACK, AND SUPPORT IS APPRECIATED **
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                      Page 7
  527.  
  528.  
  529.